home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / bbs / reqsat23 / reqsat.doc < prev    next >
Text File  |  1992-03-10  |  7KB  |  256 lines
  1.     *** REQSAT Request Satellite Mail Server V2.3 ***
  2.     *** Written by Grant Willis, VK5ZWI (c) 1992  ***
  3.  
  4. INTRODUCTION    
  5.  
  6. This server is designed to take a specially formatted REQUEST Message
  7. and readdress it with appropriate headers for forwarding via the
  8. Satellite system. It was conceived to help those who wished their
  9. mail to be directed via the Satellite Forwarding system, but who's local
  10. BBS was using Terrestrial Routes to send the mail. An example would be
  11. if a station was several VHF and/or HF BBS's away from a satellite gateway
  12. and normally mail to the region they wanted to send a message to went
  13. via a Terrestrial HF Circuit, they could send their message encapsulated
  14. in a REQSAT Request to the satellite Gateway and then the satellite
  15. gateway could forward the message via satellite.
  16.  
  17. USAGE
  18.  
  19. To use the REQSAT Server a user is required to send a message from their
  20. local BBS that looks like the following format.
  21.  
  22.    SP REQSAT @ SatGate.BBS                     <-- Command to local BBS
  23.    The Subject of their Satellite Message      <-- Subject to local BBS
  24.    SP TOCALL @ BBSCALL.ADDRESS                 <-- Address Command to Server
  25.  
  26.    Content of their message
  27.    
  28.    /EX or CTRL-Z to end their message
  29.    
  30. In the above example:-
  31.  
  32. SatGate.BBS   =  the nearest Satellite Gateway station
  33. TOCALL        =  the callsign of the station the message is to be sent to
  34. BBSCALL.ADDR  =  the BBS where TOCALL will read the message from. The .ADDR
  35.                  is the Hierarchial Extended Address. The Extended address is
  36.                  optional but is encourgaed to be included where possible.
  37.                  
  38. An example follows. This is sent by VK3XYZ in Melbourne to the Satellite
  39. Gateway in Adelaide and the contents of the message is destined for
  40. KA4AA in California USA.
  41.  
  42.    SP REQSAT @ VK5ZK.#SA.AUS.OC
  43.    Hello George!
  44.    SP KA4AA @ WA6TRY.#NOCA.CA.USA.NA
  45.    
  46.    Hello George. I havent heard you on 20M for a long time so I though
  47.    I would try a packet message via the satellites to you to see how
  48.    you are going!
  49.    
  50.    Cheers de Rob in Melbourne
  51.    Ctrl-Z
  52.    
  53. ENHANCED FEATURES
  54.  
  55. The REQSAT Server is fairly careful about what it re-addresses. If it cant find
  56. the address line in the message it sends back the HELP text to the originator
  57. of the message aswell as a copy of their message. If the users want help
  58. with the server all they need to do is send a message to REQSAT @ SatGate.BBS
  59. with no body and the server will send back the help text. Users can also 
  60. include the words HELP in the subject and Body of the message and provided
  61. they did not include an address line in the body of the message (the
  62. satellite address command) the help text will be returned to them.
  63.  
  64. SERVER OPERATIONS
  65.  
  66. This REQSAT Server handles all processing in Batch Jobs. It uses the CRON.SYS
  67. mechanism in FBB and the EX DOS mechanism in AA4RE to operate once an hour.
  68. Files for processing are forwarded to a file via the BBS Forwarding
  69. mechanism. Once the mail is readdressed it is imported back into the BBS
  70. ready to be Exported a second time to the satellite forwarding files.
  71. ONLY One forwarding R: header from the station running the server
  72. will be included in this (the second one being deleted).
  73.  
  74. REQSAT has its own REQSAT.CNF config file so that File Paths and names are
  75. compeltely user configurable. This file MUST be in the same directory as
  76. the EXE file and both should be in the same directory as the BBS program's
  77. EXEcutable files.
  78.  
  79. SERVER CONFIGURATION
  80.  
  81. To Configure the server there are several files to be modified. First
  82. edit REQSAT.CNF to set the filenames and BBS callsign to be used. Make
  83. sure that the BBS Callsign and Hierarchial Address you set in REQSAT.CNF
  84. are the same as your BBS programs.
  85.  
  86. ;
  87. ;
  88. ; REQSAT Satellite Gateway Mail Server V2.3 - CONFIG File REQSAT.CNF
  89. ; Written by Grant Willis, VK5ZWI (c) 1992
  90. ;
  91. ; BBSCALL is the callsign of the station running the server
  92. ; BBSHADDR is the Hierarchial Address of the station running the server
  93. ; INPUTFILE is the drive name\pathname\filename of the input file
  94. ; OUTPUTFILE is the drive name\pathname\filename of the output file
  95. ;
  96. BBSCALL=VK5ZK
  97. BBSHADDR=#SA.AUS.OC
  98. INPUTFILE=c:\fbbs\fbb\reqsat.out
  99. OUTPUTFILE=C:\fbbs\fbb\MAIL.IN
  100.  
  101. Next add the line indicated to CRON.SYS. This is what drives the execution
  102. of the REQSAT Server in FBB. In AA4RE you should and an EX DOS REQSAT.EXE
  103. line to WAKEUP.BB.
  104.  
  105. #
  106. # CRON.SYS file
  107. #
  108. # This file allows to parameter BBS variables
  109. #
  110. # Allowed variables are :
  111. #    YAPP PORT (YES / NO)    Binary transfers.
  112. #    GATE PORT (YES / NO)    Gateway to PORT.
  113. #    TALK (YES / NO)        Talk to sysop.
  114. #    BIP  (YES / NO)        Connection bipper.
  115. #    X Program        Executes program.
  116. #   D Program       Executes program (gives program screen write access).
  117. #
  118. # Server utilities Execution Control
  119. #
  120. D REQSAT            <<---- Add This Line here
  121. D REQFIL 
  122. X REQDIR C:\FBBS\FBB\ C:\ARCHIVE\
  123. X CARBON C:\FBBS\FBB\
  124. X FNDFIL C:\FBBS\FBB\ C:\ARCHIVE\
  125. #
  126.  
  127. Next you are required to tell the BBS what messages to forward to the
  128. REQSAT Server. This is done with the following entry in FORWARD.SYS for
  129. FBB or the new file forwarding available in the 4RE v2.12 BBS.
  130.  
  131. #
  132. #
  133. # REQSAT Server
  134. #
  135. A REQSAT
  136. P @
  137. C C:\FBBS\FBB\REQSAT.OUT
  138. B REQSAT
  139. F REQSAT
  140. #
  141. ------
  142. #
  143.  
  144. Finally in FBB BBS you need to add a BBS to BBS.SYS called REQSAT.
  145.  
  146.  
  147. # BBS Station Specification File - All Forwarding BBS's that you connect with
  148. # must be listed here.
  149. #
  150. # Do NOT delete any lines from this file
  151. #
  152. 01 VK5WI
  153. 02 VK5EX
  154. 03 VK5AFP
  155. 04 VK5ZK
  156. 05 VK5ZWI
  157. 06 VK3JAV
  158. 07 RBB1
  159. 08 KEPEL 
  160. 09 
  161. 10 KI6QE
  162. 11 SV1IW
  163. 12 ZL2AMD
  164. 13
  165. 14
  166. 15
  167. 16
  168. 17
  169. 18
  170. 19
  171. 20
  172. 21
  173. 22
  174. 23
  175. 24
  176. 25
  177. 26
  178. 27
  179. 28
  180. 29
  181. 30
  182. 31
  183. 32
  184. 33 
  185. 34 
  186. 35 
  187. 36 
  188. 37 
  189. 38 
  190. 39 
  191. 40 
  192. 41 
  193. 42
  194. 43
  195. 44
  196. 45
  197. 46
  198. 47
  199. 48
  200. 49
  201. 50
  202. 51
  203. 52
  204. 53
  205. 54
  206. 55
  207. 56
  208. 57
  209. 58
  210. 59
  211. 60
  212. 61
  213. 62
  214. 63
  215. 64
  216. 65
  217. 66
  218. 67
  219. 68
  220. 69
  221. 70 REQFIL
  222. 71 REQDIR
  223. 72 CARBON
  224. 73 FNDFIL
  225. 74 REQBIN
  226. 75 REQADR
  227. 76 REQSAT
  228. 77
  229. 78
  230. 79 MAIL
  231. 80 AMSAT
  232.  
  233. Now that once those have been added REQSAT should be operational. Test this
  234. by sending a message to REQSAT@YourBBS and put the word HELP in the
  235. SUBJECT and Message.
  236.  
  237. Check that the help text has your callsign in the right places. If in your
  238. hierarchial address you get something like VK5ZWI..#SA.AUS.OC you have
  239. added a leading '.' character to the BBSHADDR entry in REQSAT.CNF. You
  240. should remove that '.' character.
  241.  
  242. HELP
  243.  
  244. If you get stuck with REQSAT or you find a Bug please let me know. I can
  245. be contacted by Packet mail to VK5ZWI@VK5TTY.#SA.AUS.OC.
  246.  
  247. COPYWRITE
  248.  
  249. This program is copywrite (c) 1992 by VK5ZWI. It is available to amateurs
  250. free of charge. Commercial use is Strictly prohibited. You are not
  251. permitted to sell this program (except on the basis of cost recovery
  252. for floppy disks). At all times this software is to remain STRICTLY
  253. Free of charge to amateurs.
  254.  
  255.  
  256.